Programming with QuickTime VR

| Previous | Chapter contents | Chapter top | Section top | Next |

QTVRGetNodeInfo

You can use the QTVRGetNodeInfo function to get the node information atom container that describes a node and all the hot spots in the node.

OSErr QTVRGetNodeInfo (
                     QTVRInstance qtvr,
                     UInt32nodeID,
                     QTAtomContainer*nodeInfo);
qtvr
An instance of a QuickTime VR movie.
nodeID
A node ID. Set this parameter to kQTVRCurrentNode to receive information about the current node.
nodeInfo
On exit, a pointer to an atom container that contains information about the specified node.
function result
A result code.

DESCRIPTION

The QTVRGetNodeInfo function returns, in the nodeInfo parameter, a pointer to an atom container that contains information about the node specified by the nodeID parameter in the movie specified by the qtvr parameter. The atom container includes information about all the hot spots contained in that node. You can use the QuickTime atom functions (introduced in QuickTime version 2.1) to extract atoms from that container. You can also use those functions to access the hot spot atom list. All hot spot atoms are contained in the hot spot parent atom.

See the chapter handlink "QuickTime VR File Format" for a description of the format of a node information atom container and its associated atoms for a node.

SPECIAL CONSIDERATIONS

The node information atom container returned by QTVRGetNodeInfo is a copy of the atom container maintained internally by the QuickTime VR Manager. You should dispose of the node information atom container (by calling the QuickTime function QTDisposeAtomContainer ) when you're finished using it.

SEE ALSO

handlink "QuickTime VR File Format/Listing 4-3" illustrates how to call the QTVRGetNodeInfo function.

© 1997 Apple Computer, Inc.

| Previous | Chapter contents | Chapter top | Section top | Next |